home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / testipr.z / testipr
Encoding:
Text File  |  2002-10-03  |  9.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4. TTTTEEEESSSSTTTTIIIIPPPPRRRR((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        TTTTEEEESSSSTTTTIIIIPPPPRRRR((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      testipr - test an Impressario printer
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      tttteeeessssttttiiiipppprrrr [----cccc aaaallllllll | className[,className,...]] [----tttt #[,#...]]
  13.              [----pppp classPath] [----llll logPathName] [----dddd] [----hhhh]
  14.              printerName
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _t_e_s_t_i_p_r tests an Impressario supported printer. When a printer is
  18.      supported by Impressario, it can print a wide range of file formats and
  19.      offers a large selection of printing options for each file format.
  20.      Testing each supported file format and each printing option is a daunting
  21.      task if done manually one test case at a time. The _t_e_s_t_i_p_r program
  22.      automates the testing process by printing a set of standard test files
  23.      according to a standard test plan.
  24.  
  25.      _t_e_s_t_i_p_r is located in the directory /_u_s_r/_i_m_p_r_e_s_s_a_r_i_o/_t_e_s_t_s/_p_r_i_n_t.
  26.      Typically, the program is run from that directory. pppprrrriiiinnnntttteeeerrrrNNNNaaaammmmeeee is the
  27.      name of a printer installed on the system. It is recommended that the
  28.      printer be physically connected to the system on which _t_e_s_t_i_p_r is run.
  29.      During testing, the printer should not be used by other users. It is the
  30.      responsibility of the user to ensure that both of these test conditions
  31.      are satisfied.
  32.  
  33.      On startup _t_e_s_t_i_p_r looks in the /_u_s_r/_i_m_p_r_e_s_s_a_r_i_o/_t_e_s_t_s/_p_r_i_n_t directory
  34.      for test configuration files. These files are identified by a ....iiiipppprrrr suffix
  35.      and a basename corresponding to the test class name.  There are three
  36.      standard configuration files: _t_e_x_t._i_p_r, _i_m_a_g_e._i_p_r and _p_o_s_t_s_c_r_i_p_t._i_p_r.
  37.      These files comprise the text, image and postscript test classes
  38.      respectively.  Each configuration file describes a set of tests to be run
  39.      by _t_e_s_t_i_p_r.  These files should not be modified. If you wish to create
  40.      your own test cases, you can copy the existing configuration files to a
  41.      new location, modify them to suit your needs and use the ----pppp command line
  42.      option to tell _t_e_s_t_i_p_r where to find the files.
  43.  
  44.      The format of the configuration file follows that of the X Window System
  45.      resource file. For example:
  46.  
  47.  
  48.  
  49.           ! This is a comment in an example .ipr file
  50.  
  51.           test.basePath:  /usr/impressario/data
  52.  
  53.           test.1.file:    testfile.sgi
  54.           test.1.options: -rotate 90 -gamma 3.5
  55.           test.1.desc:    "SGI Image File - rotated 90, gamma 3.5"
  56.  
  57.           test.2.file:    testfile.sgi
  58.           test.2.options: -rotate 90 -gamma 3.5
  59.           test.2.desc:    "SGI Image File - rotated 90, gamma 3.5"
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTTTEEEESSSSTTTTIIIIPPPPRRRR((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        TTTTEEEESSSSTTTTIIIIPPPPRRRR((((1111))))
  71.  
  72.  
  73.  
  74.      Each resource must start with the keyword tttteeeesssstttt. bbbbaaaasssseeeePPPPaaaatttthhhh is an optional
  75.      resource that specifies a directory path. If it is specified, the path
  76.      will be prepended to each ffffiiiilllleeee resource. The ffffiiiilllleeee resource specifies a
  77.      test file to print. Typically, these test files will come from
  78.      /_u_s_r/_i_m_p_r_e_s_s_a_r_i_o/_t_e_s_t/_d_a_t_a. The ooooppppttttiiiioooonnnnssss resource specifies the actual ----oooo
  79.      model file options to be used in the test. Note that the ----oooo should not be
  80.      specified. The _t_e_s_t_i_p_r program automatically prepends the nnnnoooobbbbaaaannnnnnnneeeerrrr option
  81.      to all option strings. The option string is passed as the argument to the
  82.      _l_p command's ----oooo option. The ddddeeeesssscccc resource provides a description of the
  83.      test.  This string will be written to the test log file. Each test case
  84.      must be numbered consecutively starting with one.
  85.  
  86.      The file specified in each test is submitted for printing using the
  87.      specified printing options. A log file is created called
  88.      /_v_a_r/_t_m_p/_t_e_s_t_i_p_r.<_p_r_i_n_t_e_r_N_a_m_e>._l_o_g.  This log file contains general
  89.      information about the printer being tested and its host environment. The
  90.      log also contains a detailed list of all tests performed and their
  91.      corresponding spooling system print job IDs. A complete test record
  92.      consists of the printer output, the corresponding log file and the
  93.      /_v_a_r/_s_p_o_o_l/_l_p/_l_o_g file.
  94.  
  95.      The _t_e_s_t_i_p_r program provides the following command line options.
  96.  
  97.      ----cccc className[,className,...]
  98.                     By default, _t_e_s_t_i_p_r runs all tests for all test classes.
  99.                     The ----cccc option provides the ability to run specific test
  100.                     classes. Multiple class names may be specified by
  101.                     separating each with a comma and no whitespace. The
  102.                     keyword aaaallllllll may be specified to indicate that all test
  103.                     classes should be run; this is the default. To obtain a
  104.                     list of available classes use the ----hhhh option.
  105.  
  106.      ----tttt #[,#,...]   By default, _t_e_s_t_i_p_r runs all tests in a given class. The
  107.                     ----tttt option may be used to run specific tests within a
  108.                     class. Multiple test numbers may be specified by
  109.                     separating with a comma and no whitespace. The test
  110.                     numbers are applied to all test classes. If a given class
  111.                     does not contain a test, a warning is printed to the log
  112.                     file and testing continues.
  113.  
  114.      ----pppp classPath   By default, _t_e_s_t_i_p_r looks for test class configuration
  115.                     files in the directory /_u_s_r/_i_m_p_r_e_s_s_a_r_i_o/_t_e_s_t_s/_p_r_i_n_t. The
  116.                     ----pppp option allows a different configuration directory to be
  117.                     specified. A configuration directory can also be specified
  118.                     using the IIIIPPPPRRRR____CCCCLLLLAAAASSSSSSSS____PPPPAAAATTTTHHHH environment variable.  The ----pppp
  119.                     option takes precedence over the environment variable.
  120.  
  121.      ----llll logPath     By default, the _t_e_s_t_i_p_r program creates the log file
  122.                     /_v_a_r/_t_m_p/_t_e_s_t_i_p_r.<_p_r_i_n_t_e_r_N_a_m_e>._l_o_g. The ----llll option allows a
  123.                     different log file pathname to be specified.  Note that
  124.                     the logPath specifies both the name and directory of the
  125.                     log file.
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. TTTTEEEESSSSTTTTIIIIPPPPRRRR((((1111))))                       IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                        TTTTEEEESSSSTTTTIIIIPPPPRRRR((((1111))))
  137.  
  138.  
  139.  
  140.      ----dddd             The _t_e_s_t_i_p_r program produces a large amount of printer
  141.                     output. The ----dddd option allows the program to be run in a
  142.                     dry-run mode. In dry-run mode no print jobs are submitted
  143.                     but all other program operations are performed including
  144.                     the creation of a log file. In dry-run mode a check is
  145.                     also done to ensure that each test file can be read.
  146.  
  147.      ----hhhh             This option provides help for running the _t_e_s_t_i_p_r program.
  148.                     If the ----hhhh option is specified, the program displays a list
  149.                     of all printers available on the system and all available
  150.                     test classes.
  151.  
  152. WWWWAAAARRRRNNNNIIIINNNNGGGG
  153.      By default the _t_e_s_t_i_p_r program produces a large quantity of printed
  154.      output. A large portion of this output is text. Use the ----cccc and ----tttt options
  155.      to reduce the amount of output when running _t_e_s_t_i_p_r on printers that
  156.      primarily print image files.
  157.  
  158. FFFFIIIILLLLEEEESSSS
  159.      /usr/impressario/tests/print/testipr    Program file.
  160.  
  161.      /usr/impressario/tests/print            Default configuration file
  162.                                              directory.
  163.  
  164.      /usr/impressario/tests/data             Test file directory.
  165.  
  166.      /var/tmp/testipr.<printerName>.log      Default log file.
  167.  
  168. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  169.      testiconfig(1), impressario(1), _X _W_i_n_d_o_w _S_y_s_t_e_m by Gettys and Scheifler
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.